IAMTimelineSrc::SpliceWithNext

Microsoft DirectX 8.1 (C++)

The SpliceWithNext method joins the source object to another source object.

Syntax

HRESULT SpliceWithNext(
    IAMTimelineObj *pNext
);

Parameters

pNext

Pointer to the IAMTimelineObj interface of the source object to join to the current source.

Return Value

Returns an HRESULT value. Possible return values include the following:

Value	Description
S_OK	Success.
E_INVALIDARG	Invalid argument.
E_NOINTERFACE	Object specified by pNext parameter is not a source object.
E_POINTER	NULL pointer argument.

Remarks

As currently implemented, this method discards any effects on pNext.

For this method to succeed, pNext must be a match frame of the current source object, defined as follows:

It must share the same source file.
The media start time must equal the media stop time of the current source.
The playback rate must be the same. Playback rate is media duration divided by timeline duration.

See Also